<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>gca</title>
  </head>
  <body bgcolor="#FFFFFF">
    <center>Scilab Function  </center>
    <div align="right">Last update : 13/01/2005</div>
    <p>
      <b>gca</b> -   Return handle of current axes. </p>
    <h3>
      <font color="blue">Calling Sequence</font>
    </h3>
    <dl>
      <dd>
        <tt>a = gca()</tt>
      </dd>
    </dl>
    <h3>
      <font color="blue">Parameters</font>
    </h3>
    <ul>
      <li>
        <tt>
          <b>a</b>
        </tt>: handle, the handle of the current axes entity.</li>
    </ul>
    <h3>
      <font color="blue">Description</font>
    </h3>
    <p>
   This routine returns the handle of the current axes for the current figure.
  </p>
    <h3>
      <font color="blue">Examples</font>
    </h3>
    <pre>
   
    set("figure_style","new") //create a figure
    subplot(211)
    a=gca() //get the current axes
    a.box="off";
    t=-%pi:0.3:%pi;plot3d(t,t,sin(t)'*cos(t),80,50,'X@Y@Z',[5,2,4]);
    subplot(212)
    plot2d(); //simple plot
    a=gca() //get the current axes
    a.box="off";
    a.x_location="middle";
    a.parent.background=4;
    delete(gca()) // delete the current axes    
    xdel(0) //delete a graphics window 

  </pre>
    <h3>
      <font color="blue">See Also</font>
    </h3>
    <p>
      <a href="gda.htm">
        <tt>
          <b>gda</b>
        </tt>
      </a>,&nbsp;&nbsp;<a href="gcf.htm">
        <tt>
          <b>gcf</b>
        </tt>
      </a>,&nbsp;&nbsp;<a href="gce.htm">
        <tt>
          <b>gce</b>
        </tt>
      </a>,&nbsp;&nbsp;<a href="get.htm">
        <tt>
          <b>get</b>
        </tt>
      </a>,&nbsp;&nbsp;<a href="graphics_entities.htm">
        <tt>
          <b>graphics_entities</b>
        </tt>
      </a>,&nbsp;&nbsp;</p>
    <h3>
      <font color="blue">Author</font>
    </h3>
    <p>
    Djalel ABDEMOUCHE
  </p>
  </body>
</html>
